<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>a Statement (or Advance Statement)</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="ScoregensTop.html" title="Score Statements and GEN Routines" />
    <link rel="prev" href="ScoregensTop.html" title="Score Statements and GEN Routines" />
    <link rel="next" href="b.html" title="b Statement" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">a Statement (or Advance Statement)</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="ScoregensTop.html">Prev</a> </td>
          <th width="60%" align="center">Score Statements and GEN Routines</th>
          <td width="20%" align="right"> <a accesskey="n" href="b.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="a"></a>
      <div class="titlepage"></div>
      <a id="IndexAStatement" class="indexterm"></a>
      <a id="IndexAdvanceStatement" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">a Statement (or Advance Statement)</span>
        </h2>
        <p>a — 
      Advance score time by a specified amount.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp212261504"></a>
        <h2>Description</h2>
        <p>
      This causes score time to be advanced by a specified amount without producing sound samples.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp212262816"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>a</strong></span> p1  p2  p3</pre>
      </div>
      <div class="refsect1">
        <a id="idp212264832"></a>
        <h2>Performance</h2>
        <p>
      </p>
        <div class="literallayout">
          <p><br />
  p1    Carries no meaning. Usually zero.<br />
  p2    Action time, in beats, at which advance is to begin.<br />
  p3    Number of beats to advance without producing sound.<br />
  p4    |<br />
  p5    |    These carry no meaning.<br />
  p6    |<br />
  .<br />
  .<br />
      </p>
        </div>
        <p>
    </p>
        <div class="refsect2">
          <a id="idp212267072"></a>
          <h3>Special Considerations</h3>
          <p>
        This statement allows the beat count within a score section to be advanced without generating intervening sound samples. This can be of use when a score section is incomplete (the beginning or middle is missing) and the user does not wish to generate and listen to a lot of silence.
      </p>
          <p>
        p2, action time, and p3, number of beats, are treated as in <a class="link" href="i.html" title="i Statement (Instrument or Note Statement)"><em class="citetitle">i statements</em></a>, with respect to sorting and modification by <a class="link" href="t.html" title="t Statement (Tempo Statement)"><em class="citetitle">t statements</em></a>.
      </p>
          <p>
        An <span class="emphasis"><em>a statement</em></span> will be temporarily inserted in the score by the Score Extract feature when the extracted segment begins later than the start of a Section. The purpose of this is to preserve the beat count and time count of the original score for the benefit of the peak amplitude messages which are reported on the user console.
      </p>
          <p>
        Whenever an <span class="emphasis"><em>a statement</em></span> is encountered by a performing orchestra, its presence and effect will be reported on the user's console.
      </p>
        </div>
      </div>
      <div class="refsect1">
        <a id="idp212273104"></a>
        <h2>Examples</h2>
        <p>
      Here is an example of the a statement. It uses the file <a class="ulink" href="examples/a.csd" target="_top"><em class="citetitle">a.csd</em></a>.
      </p>
        <div class="example">
          <a id="idp212274960"></a>
          <p class="title">
            <strong>Example 1076. Example of the a statement.</strong>
          </p>
          <div class="example-contents">
            <pre class="programlisting">
<span class="csdtag">&lt;CsoundSynthesizer&gt;</span>
<span class="csdtag">&lt;CsOptions&gt;</span>
<span class="comment">; Select audio/midi flags here according to platform</span>
-odac     <span class="comment">;;;realtime audio out</span>
<span class="comment">;-iadc    ;;;uncomment -iadc if RT audio input is needed too</span>
<span class="comment">; For Non-realtime ouput leave only the line below:</span>
<span class="comment">; -o a.wav -W ;;; for file output any platform</span>
<span class="csdtag">&lt;/CsOptions&gt;</span>
<span class="csdtag">&lt;CsInstruments&gt;</span>

<span class="ohdr">sr</span> <span class="op">=</span> 44100
<span class="ohdr">ksmps</span> <span class="op">=</span> 32
<span class="ohdr">nchnls</span> <span class="op">=</span> 2
<span class="ohdr">0dbfs</span>  <span class="op">=</span> 1

<span class="oblock">instr</span> 1

aenv <span class="opc">expseg</span> .01, p3<span class="op">*</span>0.25, 1, p3<span class="op">*</span>0.75, 0.01
asig <span class="opc">poscil3</span> .8<span class="op">*</span>aenv, p4, 1
     <span class="opc">outs</span> asig, asig

<span class="oblock">endin</span>
<span class="csdtag">&lt;/CsInstruments&gt;</span>
<span class="csdtag">&lt;CsScore&gt;</span>
<span class="stamnt">f</span>1 0 16384 10 1 <span class="comment">;sine wave</span>
<span class="comment">;two sections</span>
<span class="stamnt">s</span>
<span class="stamnt">a</span> 0 0 6		<span class="comment">;advance score 6 seconds</span>
<span class="stamnt">i</span> 1 0 2 110	<span class="comment">;these first 2 notes</span>
<span class="stamnt">i</span> 1 3 2 220	<span class="comment">;will not sound</span>
<span class="stamnt">i</span> 1 6 2 440
<span class="stamnt">i</span> 1 9 2 880
<span class="stamnt">s</span>
<span class="stamnt">a</span> 0 3 6		<span class="comment">;advance score 6 seconds, but do this after 3 seconds</span>
<span class="stamnt">i</span> 1 0 2 110	<span class="comment">;this will sound, because action time (p2) from a statement = 3</span>
<span class="stamnt">i</span> 1 3 2 220	<span class="comment">;so these 2 notes</span>
<span class="stamnt">i</span> 1 6 2 440	<span class="comment">;will not sound</span>
<span class="stamnt">i</span> 1 9 2 880	<span class="comment">;and this one will</span>
<span class="stamnt">e</span>
<span class="csdtag">&lt;/CsScore&gt;</span>
<span class="csdtag">&lt;/CsoundSynthesizer&gt;</span>
</pre>
          </div>
        </div>
        <p><br class="example-break" />
    </p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="ScoregensTop.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="ScoregensTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="b.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Score Statements and GEN Routines </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> b Statement</td>
        </tr>
      </table>
    </div>
  </body>
</html>
